home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILEFIND / LOCATERD.ZIP / LOCATE.DOC < prev    next >
Encoding:
Text File  |  1993-12-17  |  5.8 KB  |  117 lines
  1.                              LOCATE (version 4.0)
  2.                             (C) 1993 Ray Dittmeier
  3.  
  4.      LOCATE is a utility that locates any file or files you ask for and gives
  5. a listing that includes, for each matching file, the entire path name, file 
  6. size, time and date.  Hidden files are indicated by the letter "H" after the
  7. file name, and directories by the letter "D".
  8.  
  9.      Simply type LOCATE, followed by a space, then the name of the file or 
  10. files you want to find.  You can give the program up to ten file 
  11. specifications; merely leave a space before each name.  LOCATE accepts the DOS 
  12. wildcard characters ? and *.
  13.  
  14.      Therefore, typing LOCATE LETTER.TXT will give you a listing of all
  15. instances, if any, of files named LETTER.TXT.  If you type LOCATE *.TXT, the
  16. program will list all .TXT files.  If you type LOCATE *.DOC *.TXT, you will
  17. get a combined list of all your .DOC and .TXT files.
  18.  
  19.      If the file specification you want ends in .* you don't have to add the
  20. .*.  For example, typing LOCATE LOCATE will give you LOCATE.EXE and LOCATE.DOC.
  21.  
  22.      If you don't give a file name when you run LOCATE, the program will ask 
  23. you for a file name or names.
  24.  
  25.      By default, this version of LOCATE searches the current drive only.  If
  26. you want it to search all drives on your system, include the switch /A or /a
  27. on the command line when you run it.  The /A switch, as well as /S (explained
  28. below), can be placed anywhere on the command line -- before or after the
  29. file names, or even in between them.  The following are all valid:
  30.  
  31.      LOCATE *.DOC /A
  32.      LOCATE /A *.DOC /S *.TXT
  33.      LOCATE *.BAK /A /S *.TXT
  34.      LOCATE /A BUDGET.*
  35.      
  36.      The number of files LOCATE will list for any given search is limited by 
  37. the amount of available memory, up to 64K, which it can find to store the 
  38. information.  This will likely be around 800 file names.  I wouldn't expect
  39. this limitation to be a problem unless you ask it to find *.* on a hard drive 
  40. system.
  41.  
  42.      LOCATE will display, at the bottom of the list, a message indicating the
  43. number of files it found.  If this is the maximum number of files it can list 
  44. with the available memory, the number will have (+?) after it, meaning there 
  45. may be more.
  46.  
  47.      Also, to make room for the above-mentioned info about each file (size, 
  48. time, date), LOCATE limits the length of each full path/file name to 55 
  49. characters.  If the full path name is too long, LOCATE will shorten it by 
  50. replacing one or more subdirectory names with an ellipsis ( . . . ).  This 
  51. shouldn't be a problem, either, unless you have an unusually elaborate 
  52. subdirectory setup.
  53.  
  54.      By default, if there are 23 or fewer files in the list, LOCATE will 
  55. display the list and then give you your DOS prompt under it.  But if the file 
  56. list requires more than 23 lines, LOCATE won't go back to the DOS prompt.  
  57. Instead, it'll display the first 23 lines of the file list.  You can scroll up 
  58. and down through it with your up and down arrow keys, and press Escape to exit 
  59. to DOS.
  60.      
  61.      LOCATE offers you several options for sorting the file list; these 
  62. options are explained below.  If you want to sort the list, include /S or /s 
  63. as a switch on your command line when you run the program.  This will cause 
  64. LOCATE not to return to the DOS prompt after displaying the file list; 
  65. instead, it will allow you to enter the following commands:
  66.  
  67. Press:
  68. Esc to return to the DOS prompt.
  69. R to sort the list by disk drive.  All files contained on the same drive
  70.   will be grouped together.
  71. N to sort the list by file name.  The entire list will be displayed 
  72.   alphabetically, according to the file name--the path name will be 
  73.   disregarded in the sort.  Files with the same primary name will be grouped
  74.   together and "sub-sorted" by extension.
  75. E to sort the list by extension.  This will allow you to group all the same
  76.   types of files together in the listing.
  77. S to sort the list by file size.
  78. T to sort the list by time of day.
  79. D to sort the list by date.
  80.  
  81.      These options are also displayed on a line at the bottom of the screen.
  82.  
  83.      All sorts are performed in ascending order.  So, for example, a sort by
  84. date will put the oldest files at the top, and the most recent at the bottom.
  85. A sort by size will put the smallest files at the top.
  86.  
  87.      After LOCATE displays the sorted list, you can perform another sort if
  88. you want.
  89.  
  90.      Sorting options are automatically enabled if the file list is large
  91. enough to scroll through -- ie, 23 files or more.  So if you want to sort the 
  92. list, and you know it will contain more than 23 files, you don't need to use 
  93. /S.  The purpose of /S is just to make sure you will be able to sort the list 
  94. if it's not long enough to scroll through (in which case, LOCATE normally 
  95. returns to DOS after displaying the list).
  96.  
  97.      (Note:  If the file list contains exactly 23 files, LOCATE will not
  98. return to DOS until you press Escape.  The entire list will fit on the screen
  99. all at once, but returning to the DOS prompt would cause the first line to 
  100. scroll off the top.)
  101.  
  102.      Press Escape at any time to return to your DOS prompt.
  103.  
  104.      LOCATE is distributed as shareware.  Copy it and give it to your friends.
  105. Upload it to bulletin boards.  If you're a distributor, put in your catalog
  106. and send me a copy.  In exchange for a registration fee of $7.00, I'll send 
  107. you a disk with more programs--the one payment covers registration for the 
  108. entire collection, so you may use any or all of the other programs on the 
  109. disk with no further obligation.  Also, I would be happy to receive any 
  110. comments, suggestions, etc., and to answer any questions (I'm happier to 
  111. answer questions if you're a registered user, but anyone's welcome to write).
  112. Send all correspondence to:
  113.  
  114.      Ray Dittmeier
  115.      P.O. Box 4724
  116.      Louisville, Ky.  40204
  117.